home *** CD-ROM | disk | FTP | other *** search
/ Aminet 48 / Aminet 48 (2002)(GTI - Schatztruhe)[!][Apr 2002].iso / Aminet / disk / misc / fat95.lha / fat95 / english / readme.too < prev   
Encoding:
Text File  |  2002-02-12  |  15.4 KB  |  463 lines
  1. fat95 readme file
  2. $VER: fat95 english information 3.01 (09-Feb-2002)
  3.  
  4.  
  5. Installation
  6. ============
  7.  
  8. * Edit the "install_fat95" text file of your language to see if it matches
  9.   your needs. You can translate your own version, and/or add a code page
  10.   description (see example "russian/install_fat95").
  11. * Doubleclick that "install_fat95" icon to activate your changes.
  12. * Doubleclick the "MS0" (internal floppy) or "MS1" example icons to mount now.
  13. * Copy them into the DEVS:DOSDrivers drawer to auto-mount at system start time.
  14. * Create your own mount scrips as needed.
  15.  
  16.  
  17. OS 1.3 specialty
  18. ================
  19.  
  20. The mfm.device does not work with V 1.3 trackdisk.device. A suitable equivalent
  21. is the messydisk.device by Olaf Seibert. It was originally distributed on a
  22. PD disk called "Time #10" 9 years (!) ago and has now become nearly
  23. unavailable. Therefore I decided to include it here.
  24.  
  25. * copy the files "messydisk.device" and "fat95mountlist" into "DEVS:"
  26.  
  27. Then add this line to your S:Startup-Sequence file:
  28.  
  29. mount ms0: from fat95mountlist
  30.  
  31. Use "ms1:" instead of "ms0:" if you want your second floppy drive to work on
  32. MS-DOS/Win disks.
  33.  
  34.  
  35. Setup
  36. =====
  37.  
  38. New with v2.18: there is only ONE fat95 file now. You can cook your
  39. own personal version yourself by editing the english/install_fat95 file
  40. and calling the install95 tool on it. This will store an accordingly modified
  41. fat95 executable into your L: drawer.
  42.  
  43. fat95 is installed in the same way as most other alternative filesystems.
  44. I tried hard to make it quite resistant against wrong or missing mountlist
  45. parameters. However, these are the important ones:
  46.  
  47. FileSystem = L:fat95
  48.  
  49. (or wherever you actually stored it, full path)
  50.  
  51. StackSize = 4096
  52.  
  53. (do not use less, you will risk a crash.)
  54.  
  55. Device = mfm.device
  56. Unit = 0
  57. Flags = 0
  58.  
  59. (which physical drive to use)
  60.  
  61. MaxTransfer = 0x20000    /* simple IDE harddisk @ A1200 */
  62.  
  63. (not needed for floppies and ATAPI devices, eg. ZIP)
  64.  
  65. LowCyl = 0
  66.  
  67. (or just no "LowCyl" entry at all.)
  68.  
  69. Buffers = 20    /* DD Floppy */
  70. Buffers = 40    /* HD Floppy */
  71. Buffers = 100   /* ZIPs, MOs, ... */
  72. Buffers = 200   /* harddisks */
  73.  
  74. (quite useful values. When using excessively deep directory trees,
  75. you can try some more buffers.)
  76.  
  77. GlobVec = -1
  78.  
  79. (this is an assembler program)
  80.  
  81. Control = "+s"
  82.  
  83. (forces fat95 into direct SCSI mode rather than trackdisk style.
  84. May help for certain harddisks > 4 Gbyte.)
  85.  
  86. And finally, the worst of all ;-)
  87.  
  88. DosType = 0x464154xx    /* "FATx" */
  89.  
  90. That last byte "xx" serves as the almighty master control.
  91.  
  92.    xx = 00     Choose this for floppies, and for floppies only.
  93.                It activates several special features like trackdisk
  94.                ETD_ commands, and a workaround for some non-mfm.device`s
  95.                that should allow for automatic HD detection now.
  96.  
  97.    xx = 01     The catch-most-of-them universal value. Works with unpartitioned
  98.                media, and will search for for the first FAT partition on
  99.                partitioned media.
  100.  
  101. If you have more than one FAT12, FAT16 or FAT32 partition on your harddisk,
  102. we will have to get a bit more detailled. Just try the LINUX style partition
  103. number:
  104.  
  105.    xx = 01..04 Use "primary" partition of that number.
  106.                "04" would be the exact value for ZIP`s, but "01" should also
  107.                work since the first 3 partition table entries are unused
  108.                on such media normally.
  109.  
  110.    xx = 05..?  Use "logical drive in an extended partition". "05" is the first
  111.                logical drive, "06" the second one etc.
  112.  
  113. You can find some examples in the file of the same name in this dir.
  114.  
  115.  
  116. General facts
  117. =============
  118.  
  119. "fat95" is designed for data exchange with other platforms. This means:
  120. media must be made 100% PC compatible. Basically, there are 2 ways of achieving
  121. this:
  122.  
  123. a) "simple", "unpartitioned"
  124.  
  125. The whole storage space of the medium is occupied by one single FAT data
  126. structure. It also implies that there is no AMIGA style partitioning info
  127. (RDB etc.).
  128. This method is common on floppies (DD and HD), magneto-optical disks (MO`s),
  129. and it is - at least in theory - also permitted on ZIP disks.
  130.  
  131. b) "partitioned"
  132.  
  133. There must be a valid PC style "master boot record" (MBR) inside the first
  134. block of the media. fat95 will then evaluate the contained partition table
  135. to figure out the type, location and size of the FAT data partition.
  136. This method is required for harddisks. Usually, ZIP media also do it that way,
  137. although in most cases there will be only one single FAT16 partition spanning
  138. almost all of the storage space.
  139. You best set up partitions using adequate PC tools like "fdisk", "xfdisk" or
  140. "PartitionMagic". These programs normally leave some unused areas between
  141. partition tables and data partitions. You may then utilize suitable AMIGA
  142. tools to ADD parallel AMIGA style partitioning info.
  143. Important: fat95 only looks at the PC style tables. Using only, for example,
  144. "HDToolBox" will thus NOT WORK.
  145.  
  146.  
  147. boot95
  148. ======
  149.  
  150. Harddisks that were partitioned on a PC often have an unused area of about
  151. 30 kbytes between the MBR and the first partition. You may now try to bring
  152. an Amiga style RDSK chain in there to make a bootable fat95 partition.
  153. First, mount that partition in the usual way, let`s say as PCHD:.
  154. Then type into a shell
  155.  
  156.     boot95 PCHD:
  157.  
  158. fat95 is needed in the L: drawer for this unless you specify a different file
  159. as a second parameter. Simply repeat the procedure to update a fat95 version.
  160. Caution: existing Amiga partition info will be overwritten!
  161. Caution again: be sure that your partition is reachable at boot time, i.e.
  162. within the first 4 Gbytes of a scsi.device disk.
  163.  
  164. My A1200 already can boot OS 3.9 off a 4 Gbyte FAT32 partition now.
  165. There are still some obstacles, however. For example, HDToolBox 3.1 has
  166. problems displaying LBA style partitions. 3.9 works better - as long as you
  167. don't try to "save the changes"...
  168.  
  169.  
  170. Special Issues
  171. ==============
  172.  
  173. When writing into the root drawer of a fat95 disk, you may get the somewhat
  174. strange error message 232 "no more entries in directory". This means:
  175. MS-DOS/Win uses a non-extensible, fixed-size root directory table that can
  176. only hold a limited number of files and sub-dirs even if there is enough
  177. space left on the disk itself. In this case, do one of the following:
  178.  
  179. * store into a sub-directory instead of the root.
  180. * move one or two files into a sub-directory, then try writing again.
  181. * delete one or two root files.
  182. * choose another disk.
  183.  
  184. Unfortunately, I still cannot fully recommend using the messydisk.device.
  185. One very annoying fact is that the MOUNT task will hang until the first
  186. disk change in the appropriate drive is performed. Perhaps this is a race
  187. condition with trackdisk device since everything works quite well in
  188. single step debugging mode.
  189.  
  190. fat95 is now able to recognize NSD (new style device) information and it can
  191. now make use of Trackdisk64 and/or SCSI direct commands for media > 4 Gbyte
  192. as well.
  193.  
  194. Due to several complaints about a disabled "FAT" workbench icon, I decided to
  195. report volumes intentionally incorrect as type "DOS\0". This will make that
  196. icon disappear. I hope and prey that this does not encourage any program to
  197. unqualified direct accessing...
  198.  
  199.  
  200. FAT32 notes
  201. ===========
  202.  
  203. The literally biggest difference compared to the older FAT16 is the so-called
  204. File Allocation Table, or FAT. It usually covers 1/1024 of the entire
  205. partition size. These are impressive 8 Mbytes on an 8 Gbyte partition, for
  206. example. Therefore fat95 does not cache 32bit FAT`s entirely. Access to
  207. fragmented files will slow down a bit this way while you are saving all that
  208. precious memory.
  209.  
  210. The variable storing the currently available free space is another good new
  211. idea... well, at least in theory. The real world does not always keep
  212. it up to date. fat95 rather chooses to calculate the free space out of the FAT
  213. in the old-fashioned way instead. This will take some time directly after
  214. mounting during which you can only read from the volume
  215. ("volume is validating").
  216.  
  217.  
  218. xxxscsi.device hint
  219. ===================
  220.  
  221. Most storage devices are controlled by the scsi.device or a similarly
  222. sounding software module of your controller board.
  223. Currently, I am using a NEC ZIP100 drive at the internal IDE port of
  224. my A1200. Unfortunately the original ROM resident scsi.device does not
  225. like ATAPI hardware at all. It only works with IDE harddisks.
  226. Therefore I recommend installing an appropriate patch, such as
  227. IDE_scsidisk or IDEfix. OS3.9 (and probably even 3.5) already comes
  228. with such a patch.
  229.  
  230. The "console"
  231. =============
  232.  
  233. fat95 doesn`t really support file comments. Reading them returns the extended
  234. date stamps, and writing them accomplishes nothing.
  235. Most of the time.
  236. Just pick a random object of a fat95 disk and assign it the comment
  237.  
  238.     !scandisk
  239.  
  240. and see what happens...
  241. This little cheat code is not perfect yet. However, it already does bring back
  242. those infamous "lost files".
  243.  
  244.  
  245. Troubleshooting
  246. ===============
  247.  
  248. ?: What does the message "object not found" mean when trying to mount
  249.    a fat95 device?
  250. !: Check the "Device =", "Unit =" and "Flags =" MountList entries.
  251.  
  252. If nothing seems to help, you can create a dump of the internal fat95
  253. variables using the included tool "debug95". For example, type into
  254. a shell:
  255.  
  256.     debug95 ms0: ram:ms0.log
  257.  
  258. if the internal floppy drive MS0: refuses to work.
  259. Then send me the just created binary file (about half a kbyte) by email.
  260. I promise there are no passwords or similar secrets in it.
  261.  
  262.  
  263. DiskDump
  264. ========
  265.  
  266. An old but useful UNIX bicycle, now brand new re-invented for Amiga (not just
  267. for fat95). Copies a sequence of disk blocks into a file:
  268.  
  269.     dd <name>.device <unit> <dest file> <block number> <count of blocks>
  270.  
  271. For example, a dump of the first 64 kbytes of my ATAPI ZIP:
  272.  
  273.     dd scsi.device 1 ram:zipdump 0 128
  274.  
  275. You can also write things back:
  276.  
  277.     dd <src file> <name>.device <unit> <block number> <count of blocks>
  278.  
  279. Unlike many disk editor programs, this will work even with defective
  280. partitions. Thus, next time fat95 swallows hard on a new disk, let`s take
  281. a look at what it was ;)
  282.  
  283.  
  284. For the specialists...
  285. ======================
  286.  
  287. ...here is a list of the supported DOS packets so far:
  288.  
  289. 0005    ACTION_DIE
  290. 0007    ACTION_CURRENT_VOLUME
  291. 0008    ACTION_LOCATE_OBJECT
  292. 0009    ACTION_RENAME_DISK
  293. 0015    ACTION_FREE_LOCK
  294. 0016    ACTION_DELETE_OBJECT
  295. 0017    ACTION_RENAME_OBJECT
  296. 0018    ACTION_MORE_CACHE
  297. 0019    ACTION_COPY_DIR
  298. 0021    ACTION_SET_PROTECT
  299. 0022    ACTION_CREATE_DIR
  300. 0023    ACTION_EXAMINE_OBJECT
  301. 0024    ACTION_EXAMINE_NEXT
  302. 0025    ACTION_DISK_INFO
  303. 0026    ACTION_INFO
  304. 0027    ACTION_FLUSH
  305. 0028    ACTION_SET_COMMENT
  306. 0029    ACTION_PARENT
  307. 0031    ACTION_INHIBIT
  308. 0034    ACTION_SET_DATE
  309. 0082    ACTION_READ
  310. 0087    ACTION_WRITE
  311. 1004    ACTION_FINDUPDATE
  312. 1005    ACTION_FINDINPUT
  313. 1006    ACTION_FINDOUTPUT
  314. 1007    ACTION_END
  315. 1008    ACTION_SEEK
  316. 1020    ACTION_FORMAT
  317. 1022    ACTION_SET_FILE_SIZE
  318. 1023    ACTION_WRITE_PROTECT
  319. 1026    ACTION_FH_FROM_LOCK
  320. 1027    ACTION_IS_FILESYSTEM
  321. 1028    ACTION_CHANGE_MODE
  322. 1030    ACTION_COPY_DIR_FH
  323. 1031    ACTION_PARENT_FH
  324. 1033    ACTION_EXAMINE_ALL
  325. 1034    ACTION_EXAMINE_FH
  326. 1035    ACTION_EXAMINE_ALL_END
  327. 4200    ACTION_SERIALIZE_DISK
  328. 4201    ACTION_GET_DISK_FSSM
  329. 4202    ACTION_FREE_DISK_FSSM
  330.  
  331.  
  332. History
  333. =======
  334.  
  335. v1.5    11/1999    first published version
  336.  
  337. v1.6    12/1999    fixed large partition addressing bug
  338.                    added workaround for SID2
  339.                    added volume serial number recognition
  340.                    added directory optimization
  341.  
  342. v1.7    01/2000    fixed minor formatting bug
  343.                    fixed crash on double-mounted volumes
  344.                    made error requesters more informative
  345.                    made code reentrant for multi-device use
  346.  
  347. v1.8    01/2000    added workaround for certain devices who keep
  348.                    trashing forbidden 68k registers
  349.  
  350. v1.11   01/2000    new workarounds for "difficult" devices
  351.                    made drawer operations a bit faster
  352.  
  353. v1.12   01/2000    added on/off feature for ETD_xxx device commands
  354.                    added ACTION_SERIALIZE_DISK packet (used by DiskCopy)
  355.                    made FAT16 mode writeback faster
  356.                    improved disk format recognition
  357.  
  358. v1.13   02/2000    fixed SERIALIZE_DISK bug
  359.  
  360. v1.14   02/2000    fixed bug in updating all FAT copies
  361.                    alternative english version
  362.  
  363. v1.15   02/2000    code optimizations
  364.  
  365. v1.17   02/2000    second published version
  366.                    improved FORMAT command support
  367.  
  368. v1.18   03/2000    first try to implement partition support
  369.  
  370. v1.19   03/2000    fixed partition selection bug
  371.  
  372. v1.20   03/2000    introduced separate directory and file caches
  373.                    added dummy workbench icon suppression
  374.  
  375. v1.21   03/2000    made file access cluster-wise
  376.                    added diskchange messsages to system (IDCMP_DISKINSERTED...)
  377.  
  378. v1.22   03/2000    fixed "large sectors" bug (> 512 bytes)
  379.  
  380. v2.0    04/2000    first try on FAT32
  381.                    fixed another "large sectors" bug
  382.  
  383. v2.1    04/2000    added NSD and TD64 support
  384.                    fixed bug on 28bit entries for FAT32
  385.                    changed intl character handling for short filenames
  386.                    fixed "file creation" timestamp
  387.  
  388. v2.2    06/2000    new restart validator routines
  389.                    longer filenames (65 chars)
  390.                    added FAT32 formatting routines
  391.                    small write access optimizations
  392.                    changed AddBuffers support (like FFS)
  393.                    reworked documentation
  394.  
  395. v2.3    07/2000    added native ExAll() and ExAllEnd()
  396.                    added ChangeMode()
  397.                    bugfixes:
  398.                      ExamineFH()
  399.                      OpenFromLock()
  400.                      Rename()
  401.                      very long path names
  402.                      Workbench support
  403.  
  404. v2.4    07/2000    bugfixes:
  405.                      exclusive locks
  406.                      double MSDOS 8.3 names
  407.  
  408. v2.5    07/2000    new buffering scheme (track-wise)
  409.                    bugfix:
  410.                      free storage space recognition on FAT32
  411.  
  412. v2.6    07/2000    bugfixes:
  413.                      crash when disk is full
  414.                      access to inconsistent files
  415.  
  416. v2.7    08/2000    fixed logigal drive recognition #07+
  417.  
  418. v2.8    08/2000    added software write protection "Lock"
  419.                    added diagnosis tool "fat95debug"
  420.  
  421. v2.9    09/2000    fixed AddBuffers bug
  422.                    ACTION_CURRENT_VOLUME now safer
  423.                    made all access trackwise
  424.  
  425. v2.10   10/2000    now recognizes some more "exotic" partition tables
  426.                    added error requester "TD64 needed but missing"
  427.  
  428. v2.11   12/2000    better FDA compatibility
  429.  
  430. v2.12   02/2001    added "SCSI direct" command support
  431.  
  432. v2.13   02/2001    new buffering system
  433.  
  434. v2.14   03/2001    fixed nasty FAT32 mode bug
  435.  
  436. v2.15   05/2001    bugfixes:
  437.                      crash on filenames >65 chars
  438.                      shutdown sequence (ACTION_DIE)
  439.                      short name generation
  440.                    new:
  441.                      "pure" attribute
  442.                      error check functions
  443.                      boot95
  444.  
  445. v2.16   08/2001    bugfix: files larger than MaxTransfer
  446.                    new: code sharing via FileSystem.resource
  447.  
  448. v2.17   09/2001    new:
  449.                      FAT32 mode now faster
  450.                      Amiga reformatted ZIPs now recognized
  451.  
  452. v2.18   12/2002    new:
  453.                      SetFileSize() support
  454.                      user defined language support for both dialog and filenames
  455.  
  456. v2.19   01/2002    new: filenames up to 104 characters long
  457.  
  458. v3.00   02/2002    added user character set for 8.3 filenames
  459.                      FAT32 formatting now uses official cluster sizes
  460.  
  461. v3.01   02/2002    fixed minor short name bug
  462. (EOF)
  463.